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Introduction 

liurdock provides the tools necessary to load and debug programs written for the Dandelion. 
Dandelion consists of two processors, the lOP and the CP. The lOP is an Intel 8085 
microcomputer with 32K bytes of PROM and I6K bytes of RAM. The CP is a 2901 bit slice 
microprogrammed processor with 16 bit wide data paths, and a control store of 4096 48 bit words. 

burdock runs on an Alto connected through its Hy Type port, hereafter called the umbilical, to the 
lOP. No direct connection between the Alto and the CP exists. Burdock communicates through 
the umbilical with the lOP kernel, a program running in the lOP. The lOP kernel in turn 
communicates through a similar interface to the CP kernel. In addition, the lOP can read and write 
the control store and a limited set of other CP registers. 

Tajo provides the foundtition upon whieh Burdock builds. This manual assumes that the reader is 
at least familiar with the Tajo user interface, can manipulate windows, and jockey the cursor around 
the display. [Reference TUG] 

Burdock consists of four main parts, the communication window, the CP panel, the lOP panel, and 
the logic analyzer. All type in and status messages appear in the communication window. The CP 
and lOP panels allow the user to examine tind alter the state of the respective processors. The logic 
analyzer formats and displays data captured by the Tektronix 7D01 Logic Analyzer. 

Burdock provides two other auxiliary windows: one for the lOP source, and the other for file 
names. The lOP source provides functions necessary for source level debugging. Burdock 
commands which need tiles from the disk get their names from the file window. Users can use the 
standard Tajo mechanisms to alter these names. Usually this window is tiny and does not occupy 
valuable display real estate. Menu items are associated with each name so tliat tlic user can invoke 
commands w ithout necessarily making the window large. Any time the cursor is in die file window 
and a name is selected, typing CR also invokes the associated command. 


Communication Window 

The communication window occupies the bottom of the display. The top line, hereafter called the 
type in. collects characters typed from the keyboard w'hen the cursor lies in the background or 
either of the two panel windows. The user can edit the type in using all of the sumdard Tajo 
editing facilities. The bottom two lines are for the timely reporting of status and errors. 
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Figure 1. An example of the display. 


Panel Windows 

A panel is a rectangular array of tiles. Fach tile displays the name of a register and its contents. A 
tile consists of three fields: in reading order these are flag, left, and right. A tilde. in the flag 
means the data in the right field is invalid for some reason. An asterisk. means the right field 
changed since the register was last read. When the cursor enters a panel. Burdock inverts the tile 
field occupied by the cursor. 

Most panel operations take the type in as an argument. Burdock evaluates arithmetic expressions in 
tlic type in strictly from left to right using long (32 bit) cardinal arithmetic. No parentheses, no 
operator precedence, and no unary operations arc allowed. Legal operators are addition ( + ), 
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subtraction (-), multiplication (*), division (/), and remainder (\). The evaluator also recognizes 
space for addition. 

To display a register, move the cursor to the left field of a tile and click red. Murdock evaluates the 
expression in the type in as the name of a register and displays the name and contents in the tile. 
To alter the contents of a register, move the cursor over the right field of a tile and click red. 
Murdock takes the type in, evaluates it, and puts the result in the register. 

Ihe other two mouse buttons are also useful. Clicking blue moves the text in the inverted field to 
the type in. Holding down yellow gets the panel menu. 

'I'o increment an address, move the cursor over the left field of a tile; hold down the left shift key 
and click the red mouse button, if the tile is not empty, Murdock increments the left field of the 
tile and displays the contents of that register in the right field. If the tile is empty, Murdock uses 
the type in rather than the tile. Decrementing w-orks by clicking the blue button with the left shift 
key down. 

Clicking shift-yellow over an empty left field clears the column below the tile. If the left field was 
not clear, Murdock fills tlic column below by successively incrementing the left field of the original 
tile. Murdock fills less than a column if it finds a number in the type in. In that case, Murdock 
only fills the number of tiles indicated. Clicking shift-yellow over a right field copies that right 
field down the column. 

Ihe user can alter the size of the panel using the standard I'ajo mechanisms. When shrinking the 
window, any tiles which disappear are thrown away. When the window grows, all newly uncovered 
tiles are blank. Making the window tiny does not disturb any tile. 

lOP 

Raw numbers in the left field are interpreted as addresses in lOP main storage, 'fhe names 
Murdock uses for the 8085 internal registers are listed in the following table. I'he numbers in 
parentheses indicate the size, in bits, of the register. 

A(8). M(8). C(8). 1X8), Flags(8), F:(8), H(8), 1.(8), PC(16), PCH(8), PCI.(8), RIM(8), 

SI^(16), SPH(8), SP1.(8) 

Notice that A, M, C, IX and H are all legal hex constants as well as internal 8085 registers. Murdock 
handles these as special cases and always displays the contents of the internal register in die right 
field of its tile. To examine main memory locations A through H, use a preceeding 0. 

The top line of the panel provides a list of commands which execute with a click of the red mouse 
button. These commands are listed in the table below in the order they appear on the display. 


Moot 

boot the lOP kernel 



Load 

load die lOP 



Start 

use the selection in the lOP 

source and start 

the lOP 

Stop 

stop the lOP 



Continue 

continue the lOP 



Step 

execute a single instruction 



StepFrom 

use the selection in the lOP 

source and execute 

that instmetion 


1 he functions Boot, Start. Continue, Step, StepFrom, and Stop are also available from the menu. 
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Update is an additional function available from the menu. Update rereads registers and redisplays 
all tiles in the panel. 

If communication breaks down between the lOP kernel and Murdock over the umbilical, any of the 
following error messages might appear in the communication window; LSAckStillOn, 
I.SAckStillOff, or USRcqStillOn. If booting the lOP docs not restore communication, hardware 
problems probably exist in either the lOP or the umbilical. 


Source Level Debugging 

All break points must be set and cleared through the lOP source window. Also, Start and 
Sicpl roin lake liieir parameters as a text selection in the lOP source window. The assembler and 
binder both produce files used by the source level debugging features. The assembler derives the 
address map (.am) from the source (.asm), fhe address map holds the values of symbols defined in 
the source and keeps the correspondence between the text and relocatable binary. The binder 
produces ;i file map (.fm) and an absolute bintiry (.bin), fhe file map has the values of globally 
defined symbols and the correspondence between source files and absolute storage locations. 

lb change the file disphiycd in the lOP source (.asm), use the lOP Source line of the lllc window. 
Switching the source also switches the symbols. When using the ptmel, remember that symbols 
dofined loctilly arc accessible only when the proper source is loaded. ( I his. of course, docs not 
apply to globally defined symbols.) Whenever switching to a source tile not in the file map, 
Murdock insists on a red button click for confirmation, 'fhe symbols remain unchanged after an 
explicit confirmation. Clicking yellow aborts the switch. 

lb set a break point, move the cursor to the line where the break point is to go in the lOP source 
window. Get the Mrcakpoint menu and select Set. A grey underline will appear on the line where 
the break point will go. A subwindow will appear at the bottom of the source window. If you 
decide not to set the break point after all. bug Never Mind and all is forgiven. Mcforc confirming 
by bugging Set, you can specify conditions and 'fracc Items. After setting the break point, Murdock 
highlights the line with a grey background. 

'lb clear a break point use the cursor to point to the line and use Clear from the breakpoints menu. 
Murdock clears the break point and removes the grey highlight from the display. 

Meware of a few irregularities. Dt) not set break points on calls or try to step through a return 
instructions, break points do not work when SP points into ROM or nonexistent memory. 


CP 


Raw numbers in the left field are interpreted as virtual addresses in CP main storage. The 48-bit 
microinstructions arc displayed as ordered triples of sixteen-bit hex constants separated by commas. 
The names Murdock uses for the processor registers arc listed in the following table. See the DMR 
for detailed descriptions of these registers. [Reference DMR]. fhe numbers in parentheses indicate 
the number of registers of that type and the word size. All numbers arc in hex. 


.cR (1000 X 30) 
.cV (1000 X 30) 
.KKHrr (1x2) 
.IM (3 X 8) 
.IBPtr (1x2) 


control store real address 
control store virtual address 
cmulator/kcrncl error register 
Mesa byte code buffer 
IM buffer index 
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.lOOutdO X 10) 

(write only) device control control registers and output buffers 

.lOXin (10 X 10) 

(read only) device status registers and data input buffers 

.Link (8 x 4) 

microcode subroutine linkage registers 

.Map (4000 X 10) 

main storage page map 

.Mint (1x1) 

Mesa interrupt flag 

.MR (.10000 X 10) 

main storage real address 

.MV (400000 X 10) 

main storage virtual address 

.pdf') (1 X 1) 

Mesa byte code pc extension selects byte in word 

.(; (1 X 10) 

internal 2901 register 

.R (10 X 10) 

high speed scratch pad 

.RII (10 X 8) 

main storage address extension (.RH + T’ used by the kernel) 

.stackP (1x4) 

Mesa evaluation sltick pointer 

.TC (8 X 4) 

Uisk dispatch/branch bits 

.'TPC (8 X C) 

task program counters (.TPC + 6 reserved by lOP, .'TPC + 7 used by 
kernel) 

.U (100 X 10) 

low speed scratch pad 


'I hc top line of the panel provides a list of commands which execute with the click of the red 
mouse button. These commands arc listed in the table below in the order they appear on the 
display. 


Boot 

l-oad 

Start 

Stop 

Continue 

Break 

Unbreak 

l.oadKcal 


load and start the CP kernel, boots the lOP only if necessary 

load control store (.fb) and symbol table (.st) 

start the CP, use the type in as the starting address 

stop the CP 

continue the CP 

use the type in as an address and set a break point 
use the type in and clear the break point 
load main storage from a .cpr format file 


The functions available from the menu are listed in the following table. 


Resume 
Unbreak * 
List breaks 

Alternate 

ClrPanel 

ClrBrcaks 

Reset 

Update 


continues both the lOP and CP 

clears the last break point hit by the CP 

lists, in the Hxec window, all the break points currently set, indicates 
the last break point hit by tlie CP with a * 

display an alternate representation of the tile field in the type in, 
uses the tile field selected when the yellow button was pushed 

clears all tiles in the panel 
clears all break points 

disables all tasks, except the lOP, and sets TPCs to their initial values 
rereads the contents of registers and redisplays all tiles in the panel 
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I'he Uoj>ic Analyzer 

The logic analyzer window displays and formats data captured by the 'fektronix 7D01 logic 
analyzer. I he window is divided into two parts: the top part conUiins parameters used to format 
and display the data. The bottom part of the window contains the data captured by the logic 
analyzer. Ihis data is standard read only Tajo text; scrolling, thumbing, and selecting text all work, 
lo copy logic analyzer data, use the fajo text selection and stuffing mechanisms. 

When the analyzer is not triggered, the data display is blank and tlie name frame says 
"Untriggered". When the analyzer triggers, burdock displays the data in its window, highlighting 
the trigger line with a grey background, and writes the raw trigger pattern in the name frame. Tven 
(hough the 71)01 allows different word sizes. Murdock formats only sixteen hit words. Any other 
setting of the word size sv. iicfi on the 71)01 provokes protocol errors. Murdock indicates this by 
putting "Protocol Paror" in the name frame. 
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Figure 2. I'he logic analyzer in NIA mode. 

Hach line of the data display has two fields followed by two optional fields. The first field is the 
line number of the display in decimal. The second field is the formatted data. The first optional 
field is the match number in decimal (see the explanation of filtering below). An asterisk at the 
end of the line indicates the current match. 
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Items on the logic analyzer menu arc listed in the following table. 


Octal 

display data in octal 

Hex 

display data in hex 

Decimal 

display data in decimal 

Binary 

display data in binary 

NIA 

(the default) disassemble the low order twelve hits as symbolic CP 
control store addresses, radix is hex, display the other four bits as a 
hex digit (see Figure 2) 

Test 

toggle the logic analyzer test mode (only for wizards) 

Read 

read the analyzer and display the data 

Reset 

reset the logic analyzer trigger, clear the data 


liiirdock uses llic Mask and Xor parameters as hex numbers to mask and invert bits on each line of 
the display. Burdock lust docs the xor then ands the mask with the data before displaying. The 
default values (7i'l-'l- for Mask and UFF for Xor) were chosen for display of CP control store 
addresses. Typing a CR v^hen changing the Mask or the Xor redisplays the data. 

Burdock provides facilities to search for patterns in the words of data. The pattern goes in the 
parameter labeled Filter. With Filter selected, typing CR builds a new list of matches and 
redisplays the data. All matches arc numbered in decimal starting at 0. If a line matches the 
pattern, the match numher appears at the end of the line. An asterisk after the match number 
indicates the current match. 

Two characters in a pattern have special meaning. An asterisk (*) matches any substring including 
the null subtring. A sharp (#) matches any single character. When searching the data. Burdock 
first converts the pattern to a string in the current radix. If the pattern is not a legal number with 
wild cards (asterisks and sharps) Burdock tries to evaluate the string as an arithmetic expression 
using the CP symbol table. If the pattern proves illegal, the display blinks and Burdock gives up. 
To explicitly overide the current radix when the pattern is a number with w'ild cards, append any of 
tlic following characters to the pattern; exclamation point (!) for binary, single quote (') for octal, 
decimal point (.) for decimal, or X (either upper or lower ease) for hex. 

After computing the pattern. Burdock converts each word of the data to a character string and tests 
it against the pattern. If the word matches. Burdock adds it to the match list. After scaching 
tlirough all the data. Burdock sets the current match to the first match in the list and makes it 
visible in the display. Ihe functions Next, First, Last, and Back move the current match through 
the match list. If any of these functions move the current match off the display, Burdex-'k redisplays 
so that the current match is one quarter of the way from the top. Last moves to the last match in 
the list. First moves to the first match. Next moves to the next match. Back moves back one 
match in the list. 


I'he Kther Kludge 

Burdock can act as an cthcrnct controller for the Dandelion. When the Dandelion requests ethernet 
service. Burdock enters ether mode by turning off the display and setting, the ether mode cursor, 
■flic cursor inverts for each requested StartlO. While in ctlicr mode. Burdock ignores all keyboard 
and mouse input exeept DHL. Typing DHL stops the lOP, turns the display back on. and forces 
Burdock back to command level. 
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When Burdock starts, it will take a command file name from the command line. 'I'o execute a 
command file after Burdock has already started, select the "Command" parameter in the files 
window and type the file name ending w'ith a CR. (In both eases. Burdock assumes ".burdock" for 
a file name extension). I'xccution begins immediately after the CR. To stop a command file while 
it executes, type l)KI.. I'his gets Burdock listening to keyboard commands again; however, you 
cannot continue your command file. Burdock ignores all other keyboard and mouse input while a 
command file runs. 

Command files contain three types of statements: function calls, tile definition, and conditionals. 
All statements must be separated by semicolons. Any statement may begin with one or more labels; 
a label consists of an ideniilier followed by a colon (:). Spaces and carriage returns are ignored. 
Matching vertical bars (|) delimit comments. Comments may be any length and span more than 
one line. 


A tile definition statement fills a panel tile and has one of two forms (optional fields are in bold 
face): 

TileNanic = I'aiicll.oc ! IxflFicld *■ RightField 
or 

Tilel.uc ! I.efil'ield *- RightField. 

A TileNamc is simply an identifier used to name a tile. TileNaiim are useful in conditionals. 
I'aneH.uc^ arc specified by an ordered pair of hex constants indicating row and column. IOP(0, 0] 
is the upper left tile of the lOP panel. CP[11, 2] indicates the lower right hand tile of the initial CP 
panel. A Tilel.uc is cillicr a TileNuine or a Rauell.oc. l.e/iluelcl and liightl'ield arc the initial 
contents of the tile. They can be any strings that do not contain the characters left arrow («-), colon 
(;), semicolon (;), quote ("), equal ( = ), sharp (#), greater than (>), less tlian «), or open bracket 
(1). The left arrow («-) and Right Field go together and arc optional. 

A conditional has the following form: 

IF OperandRelaliunal Operand'l'HF.N {statements}. 

riic Relationals include less tlian (<), less than or equal (< = ). equal ( = ), not equal (#), greater 
than 0), and greater than or equal (>=). An Operand is either a hex constant or a TileName. 
Burdock evaluates the relation using integer (signed) sixteen bit arithmetic. If false the conditional 
skips the stuff between the matching braces. If true Burdock starts executing statements. 
Conditionals can be nested to any level. 


A function call consists of the function name followed by its parameters in square brackets. A 
function with no parameters still requires square brackets after the function name. Use a comma (,) 
to separate the parameters. Any parameter which has characters that might confuse the scanner 
must be enclosed by double quotes ("). 


Command file functions (arguments in bold face are optional). 


A1 ter A ddress[ TileN ame. string 

Boot[] 

BootlOP[] 

BootMesal.s7/7//g] 

Break[s/ri//g] 


appends string to the left half of the tile and redisplays 
tile 

boots the CP kernel 

boots the lOP kernel, displays internal registers in panel 
loads CP main storage from a .boot format file 
sets CP break point at specified location 
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lircakIOP[.v/r//7g] 
CV\nuinber, number] 
ClcarCPI’anclf] 
CIcarlOPPancl(] 

Closed 

Con ti niic[ timeOut] 

ContiniiclOP[r/me(^ttr] 

Go'\'o[labeI\ 

\0\*\nunibcr, number] 

I .oad(.v//7«i'J 
I .oadlOI*(.v//-///g] 

I .oadPcaIf.v/r//?;;] 
NoSyrnbolsI .oad[.v/r//;>,>| 
Open I ()Appcnd|,v/m/g] 
Open I ()Wriic|.s7/7/i^'] 
l^ick| TileName] 

Pick Append! TileName] 
Start[.s7r///^;, tinieOut] 
SairtlOI‘[i7/7//g, timeOut] 
Stop!) 

StoplOP[] 

Stu ffAddress[7'/7(’A^fl/ne] 

S tu ffP cgister! r//eA^rt/7!e] 
Typeln[i7r/«g] 
I'ypelnAppendfs/rmg] 
Unbrcak[i7/7>;g] 

Unbreak 10P[5m«g] 

Writcfi/nVig] 

Writel.inc[s/r//?g] 

W riteUocI TileName] 
Write Timcfl 


sets lOP break point at specified location 
CP tile location row and column 
clears the CP panel 
clears the lOP panel 
close the log file 

continues CP, time out is in milliseconds 
continues lOP, time out is in milliseconds 
goes to label in command file 
lOP tile location row and column 
loads CP control store 
loads lOP storage, might switch lOP source 
loads CP main storage from .cpr format file 
load CP control store, no symbols arc loaded 
opens log file, appends to tlic end of the file 
opens log file, previous contents of file are lost 
replaces the type in by the right field of tile 

appends the right field of tile to the type in 
starts the lOP at .v/rd/g, time out is in milliseconds 

starts the lOP at siring, time out is in milliseconds 

stops the CP 
stops the lOP 

stuffs type in into left field of tile 

stuffs type in into right field of tile 

replaces the type in by siring 

appends siring to the type in 

clears specified CP break point 

clears specified lOP break point 

write siring into log file 

writes siring followed by a CR into log file 

writes right half of tile into the log file 

writes time into the log file 


All time outs arc speefied in milliseconds. If a function times out, the command file stops 
immediately and Burdock returns to keyboard command level. A function with a time out of zero 
can never time out. Omitting a lime out altogether means the function returns immediately and 
command file processing continues. 
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Consider the following example of a command file. 

R= CP[0, 0]! .r; [define symbolic panel locationsi 
CP[0, 1]! .u+9: [this form works tool] 

U= CP[1, 0]; 

M= CP[2. 0]: 

X= CP[3, 0]; 

Typeln["l"]; StuffRegister[R] ; [puts a 1 .r| 

A1terAddress[R, "+1"]; [display .r+1 in R[ 

A1terAddress[R, "-1"]; [display .r in R[ 

Pick[R]; StuffAddress[M]: [display virtual memory location 1 at M[ 

Typeln[".tpc+"] : PickAppend[R ]; StuffAddress[X]; [show .tpc+1 at 
X| 

TypeInAppend["+4"]; StuffAddress[X]; [display .tpc+5 at X| 

lypein takes a single argument and puts that into the type in. TypcInAppcnd appends to rather 
than replaces the type in. 

StuffRegister takes a single argument, a symbolic panel location, and puts the type in into the right 
Held of the tile. 

AltcrAddrcss takes two arguments, a symbolic panel location .ind a string. Murdock takes the left 
field of the tile appends the siring argument and puls the result back into the left field. 

Pick takes a symbolic panel location and puts the contents of the right field into the type in. 
PickAppend works in a similar fashion, but appends rather than replaces the type in. 

StuffAddress takes a panel location and puts the type in into the left field. 


'I'hc C'ommund Window 

CommandWindow provides facilities for running any one of an array of Murdock command files at 
die click of a mouse button. I hc w'indow itself contains names separated by spaces. To run a 
comand file, use the cursor to point at a name and click red. (Click only once!) Murdock takes the 
name, assumes an extension of .burdock, opens that file, and executes it. 

You must start CommandWindow in a running Murdock using the Create-Tool command available 
from the background menu. The initial text in the command w'indow comes from the commands 
line of the Murdock section of user.cm. (See the section on practical matters for more details.) To 
alter the contents of the window, set the insertion point, and type. Use MS and MW for editing: no 
other editing commands arc available. 

The tool is available from [Iris]<Workstation>Jarvis>CommandWindow.bcd. 


Practical Matters, or Making Murdock Work on Your Disk 

To get Murdock up and running automatically, retrieve flris[<Workstation>Jarvis>Murdock60.cm on 
to your disk and execute it as an AlU) executive command file. This gets Murdock running on your 
Alto. Arrange the windows in a pleasing manner and make a checkpoint. The rest of this section 
explains how MurdockfiO.cm works: if you arc not interested, skip it. 

Before Burdock can function, it requires that several files be on your disk; these arc listed in the 
following table. 
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RunMcsa.run 
Mesa, image 
MesaFonLstrike 
SmallAlto'I'ajo.bcd 
riurd(K:k.bcd 
8085asm.<)ps 
Kernel.fb 
nurdock.ovcrlays 


loads and suirts Mesa.image 

the Mesa runtime environment 

display font definition used by Mesa and Tajo 

the tools environment 

Burdock 

definition of the 8085 symbols 

the CP kernel 

more of the CP kernel 


Murdock gets several hints from user.cm. The example below can be found in 
[lris]<Workstation>Jarvis>Burdock.cmSlice. 


[TOOLS] 

Bitmap; [x: 32, y; 112, w: 544, h: 591] 

[Burdock] 

Commands: Boot Mesa CursorTest CursorTrack 
Symbols: Swatee 

Ihe larger the display bitmap, the less room Burdock has for symbol tables and code. Conversely, 
working with a cramped bitmap can be difficult. The bitmap above seems to be a good 
compromise. (The si/c of the bitmap is not as important for Altos with more than 128K.) T'he 
commands window gets its initial contents from the commands line. T he commands window reads 
through user.cm only at creation time; it does not look everytime Burdock runs. Burdock uses 
Burdock.scratchSym as a swapping store as it runs; to change this lilc, use the symbols line. Using 
Swatee instead of Burdock.scratchSym saves 50-60 pages on your disk. 

T'o suirt a fresh Burdock, type the following command line from the Alto executive. 


Mesa.image Smal1AltoTajo Burdock/l <optional-command-file-name> 

T his starts Burdock running and executes the command file (if specified). To include other tools, 
insert their names before the Burdock/1. 
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Break! sets a break at the current selection. 

(lOP)Stack! displays the top ClumpSize words on the stack. 

(IOP)Instructions! Takes the current selection, and prints out ClumpSize instructions. 


Panels: 

Note that there is a separate Typein for each panel. 

If the Typein is empty, the current selection is used. 

Mouse operations (possibly LeftShifted) work as in Alto Burdock. (I think.) 
Point (left mouse button) stores Typein into the blackened tile slot. 
Adjust appends the current tile slot to Typein. 

LeftShift+Point bumps the contents of the LH by +1. 

LeftSh i rt+AdJust bumps the contents of the LH by -1. 

LeftShift+Point+Adjust (Menu) fills the column by adding +1 each step. 


Builtin symbols: 

lOP registers: B, C, D, E, H. L, M, A, PCH, PCL, SPH, SPL, Flags, RIM. 

Register pairs: BC, DE, HL, SP, PSW, PC. 

If an expression (in the LH of a tile in the lOP panel) for an address in lOP memory begins with a S 
the address will be displayed in word mode. (The contents of register pairs are automatically 
displayed in word mode.) A % displays an instruction. 

CP: .CR (control store real). .CV (control store wirtural), .RH, .R, .U, .TPC, .TC, .LINK, .MAP, .MR 
(main memory real), .MV, .lOIN, .lOOUT, .0, .IB, .PC16, .STACKP, .IBPTR, .MINT, .EKERR, .UI. 


Bugs: 

It will probably crash if you get to a breakpoint in the wrong cycle. (This hasn't happened to me 
yet.) 

Burdock automatically appends the "right" extension when it goes to read a file. This is a pain for 
loading the germ because it wants PilotDLion.cpr rather than PilotDLion.germRM. You will have to 
edit your Germ.burdock and/or rename/copy your PilotDLion.germRM. 

Occasionally a tile goes into hyperspace. The symptom is that the RH is blank, and doesn't get fixed 
up on repaint. To recover the screen area, delete that tile (store empty into the LH) and start over 
again. 


See also Burdock.restrictions. 
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// Burdock.restrictions, HGM, 18-0ct-8Z 13:35:08 

Pending branch/disps are lost on c2 or c3 breaks. (Store them into UKSaveDisp by hand if you know 
what's going on and/or you are desperate.) 

c2 breaks on write clicks won't write anything. 

c2 or c3 breaks on read clicks will get trash from «-MD when you continue. 

You can't put breaks on c*. or on instructions without symbols. 

You can't put breaks on instructions used by more than one task. 

You can't set a TPC to anything other than an instruction in cl. 

c2 or c3 breaks in 10 tasks may not take when expected since the task has to run one more click to get 
to the kernel. (If the current click turns off wakeups so it doesn't get scheduled again....) 

Breaks after IBDisp won't work. 

Breaks during bank switching will get confused. 

Continue after breaking after AltUAddr won't work. 

You can't write into a task's TC bits. 

You can't read the 2 (MagTape) input registers that are located in the "output" clump of the function 
fields. 

Things will get all confused if you get 2 breaks at the same time. This can happen if the first break 
in in c2 or c3 since the EtnerKernel doesn't happen until the next click. 
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